<para>
In most cases, the code is as simple to build as running:
</para>
-<para><command> ./configure && make</command></para>
+<para><userinput> ./configure && make</userinput></para>
<para><ulink url="http://expat.sourceforge.net">Expat</ulink>
is strongly recommended for source builds as it is
required for reading all the XML formats such as GPX.
<para>There are additional flags that can be passed to configure to
customize your build of GPSBabel.
</para>
-<para><command>./configure --help</command></para>
+<para><userinput>./configure --help</userinput></para>
<para>
lists all the supported options, but additionally we have:
<option>--disable-shapefile</option> Excludes the shapefile support.
"mystyle.style" and you want to write the waypoints from
a GPX file named "mine.gpx" to it, you would issue a command like:
</para>
-<para><command>gpsbabel -i gpx -f mine.gpx -o xcsv,style=mystyle.style -f mine.new</command></para>
+<para><userinput>gpsbabel -i gpx -f mine.gpx -o xcsv,style=mystyle.style -f mine.new</userinput></para>
<para>
You might then examine <filename>mine.new</filename> to see if it met
your expectations. If not, you could continue to tweak
The <parameter class="command">format</parameter> parameters in the above list
refer to the names of formats or file types supported by GPSBabel.
</para>
-<para><command>gpsbabel -? </command></para>
+<para><userinput>gpsbabel -? </userinput></para>
<para>will always show you the supported file types. In this document, the
various supported formats are listed in <xref linkend="The_Formats" />. The
name that you would use on the command line follows the format name in
this program, just tell it what you're reading, where to read
it from, what you're writing, and what to write it to. For
example:</para>
- <para><command>gpsbabel -i geo -f /tmp/geocaching.loc -o gpx -F /tmp/geocaching.gpx</command></para>
+ <para><userinput>gpsbabel -i geo -f /tmp/geocaching.loc -o gpx -F /tmp/geocaching.gpx</userinput></para>
<para>tells it to read the file "/tmp/geocaching.loc" in geocaching.com
format and create a new file in GPX format.</para>
<para> This command will read from a Magellan unit attached
to the first serial port on a Linux system (device names will
vary on other OSes) and write them as a geocaching loc file.
The second command does the same on Microsoft Windows.</para>
- <para><command>gpsbabel -i magellan -f /dev/ttyS0 -o geo -F mag.loc</command></para>
- <para><command>gpsbabel -i magellan -f com1 -o geo -F mag.loc</command></para>
+ <para><userinput>gpsbabel -i magellan -f /dev/ttyS0 -o geo -F mag.loc</userinput></para>
+ <para><userinput>gpsbabel -i magellan -f com1 -o geo -F mag.loc</userinput></para>
<para>Optionally, you may specify <parameter moreinfo="none">"-s"</parameter> in any command line. This
causes the program to ignore any "short" names that may be
present in the source data format and synthesize one from the
the 'GC1234' ones that are optimized for NMEA-only receivers.
A geocacher with a Magellan receiver may thus find commands
like this useful.</para>
- <para><command>gpsbabel -s -i geo -f geocaching.loc -o magellan -F /dev/ttyS0 </command></para>
- <para><command>gpsbabel -s -i geo -f geocaching.loc -o magellan -F com1</command></para>
+ <para><userinput>gpsbabel -s -i geo -f geocaching.loc -o magellan -F /dev/ttyS0 </userinput></para>
+ <para><userinput>gpsbabel -s -i geo -f geocaching.loc -o magellan -F com1</userinput></para>
</sect1>
<sect1 id="Suboptions">
<title>Suboptions</title>
itself. The available suboptions are listed on the individual
format pages. We'll make an example from <xref linkend="fmt_kml" />:
</para>
- <para><command>gpsbabel -i gpx -f file.gpx -o kml,deficon="file://myicon.png",lines=0 -F one.kml -o kml -F two.kml</command></para>
+ <para><userinput>gpsbabel -i gpx -f file.gpx -o kml,deficon="file://myicon.png",lines=0 -F one.kml -o kml -F two.kml</userinput></para>
<para>
This command will read the GPX file <filename>file.gpx</filename>
and create two KML files. <filename>one.kml</filename> will
<parameter moreinfo="none">-i</parameter> argument is seen.
Files are read in the order they appear. So you could merge
three input files into one output file with: </para>
- <para><command>gpsbabel -i geo -f 1.loc -f 2.loc -f 3.loc -o geo -F big.loc</command></para>
+ <para><userinput>gpsbabel -i geo -f 1.loc -f 2.loc -f 3.loc -o geo -F big.loc</userinput></para>
<para>You can merge files of different types:</para>
- <para><command>gpsbabel -i geo -f 1.loc -i gpx -f 2.gpx -i pcx 3.pcx
--o gpsutil -F big.gps</command></para>
+ <para><userinput>gpsbabel -i geo -f 1.loc -i gpx -f 2.gpx -i pcx 3.pcx
+-o gpsutil -F big.gps</userinput></para>
<para> You can write the same data in different output formats:</para>
- <para><command>gpsbabel -i geo -f 1.loc -o gpx -F 1.gpx -o pcx 1.wpt</command></para>
+ <para><userinput>gpsbabel -i geo -f 1.loc -o gpx -F 1.gpx -o pcx 1.wpt</userinput></para>
<para>If you want to change the character set of input or/and
output side you can do this with the option <option>-c
<character set></option>. You can get a complete list
of supported character sets with "gpsbabel -l". To change
the character set on both sides you should do this:</para>
- <para><command>gpsbabel -i xcsv,style=foo.style -c latin1 -f foo -o xcsv,style=bar.style -c ms-ansi -F bar</command></para>
+ <para><userinput>gpsbabel -i xcsv,style=foo.style -c latin1 -f foo -o xcsv,style=bar.style -c ms-ansi -F bar</userinput></para>
<para>Note, that some formats has a fixed character set and ignore this option.</para>
</sect1>
<sect1 id="Route_And_Track_Modes">
waypoints, and is the default. So if you wanted to read all
data from your unit into a gpx file, you might use a command
like:</para>
- <para><command> gpsbabel -t -r -w -i magellan -f com1: -o gpx -F backup.gpx</command></para>
+ <para><userinput> gpsbabel -t -r -w -i magellan -f com1: -o gpx -F backup.gpx</userinput></para>
<para> Tracks and routes are advanced features and don't try
to handle every possible hazard that can be encountered
during a conversion. If you're merging or converting files
(i.e. wrapper applications using GPSBabel in the background).
The inifile mechanism can be disabled with an empty filename.
</para>
- <para><command>gpsbabel -p "" -i gpx -f something.gpx -o tiger -F -</command></para>
+ <para><userinput>gpsbabel -p "" -i gpx -f something.gpx -o tiger -F -</userinput></para>
</sect1>
<sect1 id="tracking">
<title>Realtime tracking</title>
inputs and KML is supported on output. Additional formats
may be added by interested parties later.
</para>
- <para><command>gpsbabel -T -i garmin -f usb: -o kml -F xxx.kml</command></para>
+ <para><userinput>gpsbabel -T -i garmin -f usb: -o kml -F xxx.kml</userinput></para>
<para>
Will read the USB-connected Garmin and rewrite 'xxx.kml' atomically,
suitable for a self-refreshing network link in Google Earth.
Here is an example demonstrating segmenting a large command line
by placing the input and filtering directives in a file called 'all_my_files'.
</para>
- <para><command>gpsbabel -b all_my_files -o gdb -F all_my_tracks.gdb</command></para>
+ <para><userinput>gpsbabel -b all_my_files -o gdb -F all_my_tracks.gdb</userinput></para>
<para>
'all_my_files' could look like this:
</para>
would include only points within one mile of the section of Lima Road
covered by the arc.
</para>
-<para><command>gpsbabel -i geo -f 1.loc -x arc,file=lima_rd.txt,distance=1 -o mapsend -F 2.wpt</command></para>
+<para><userinput>gpsbabel -i geo -f 1.loc -x arc,file=lima_rd.txt,distance=1 -o mapsend -F 2.wpt</userinput></para>
</example>
</para>
<example id="example_discard_filter">
<title>Using the discard filter</title>
-<para><command> gpsbabel -i gpx -f in.gpx -x discard,hdop=10,vdop=20,hdopandvdop -o gpx -F out.gpx</command></para>
+<para><userinput> gpsbabel -i gpx -f in.gpx -x discard,hdop=10,vdop=20,hdopandvdop -o gpx -F out.gpx</userinput></para>
</example>
<para> Contributed by Tobias Minich.</para>
<link linkend="fmt_gpx">gpx</link> file that more than likely
contains only unique points and point data.
</para>
- <para><command> gpsbabel -i gpx -f 1.gpx -f 2.gpx -x duplicate,location,shortname -o gpx -F merged_with_no_dupes.gpx</command></para>
+ <para><userinput> gpsbabel -i gpx -f 1.gpx -f 2.gpx -x duplicate,location,shortname -o gpx -F merged_with_no_dupes.gpx</userinput></para>
</example>
This command line reads track.gpx and inserts points wherever two adjacent
trackpoints are more than 10 seconds apart:
</para>
-<para><command>gpsbabel -i gpx -f track.gpx -x interpolate,time=10 -o gpx -F newtrack.gpx</command></para>
+<para><userinput>gpsbabel -i gpx -f track.gpx -x interpolate,time=10 -o gpx -F newtrack.gpx</userinput></para>
<para>
This command reads track.gpx and inserts points wherever two adjacent
trackpoints are more than 15 kilometers apart:
</para>
-<para><command>gpsbabel -i gpx -f track.gpx -x interpolate,distance=15k -o gpx -F newtrack.gpx</command></para>
+<para><userinput>gpsbabel -i gpx -f track.gpx -x interpolate,distance=15k -o gpx -F newtrack.gpx</userinput></para>
<para>
This command reads track.gpx and inserts points wherever two adjacent
trackpoints are more than 2 miles apart:
</para>
-<para><command>gpsbabel -i gpx -f track.gpx -x interpolate,distance=2m -o gpx -F newtrack.gpx</command></para>
+<para><userinput>gpsbabel -i gpx -f track.gpx -x interpolate,distance=2m -o gpx -F newtrack.gpx</userinput></para>
</example>
you may use this filter to remove the waypoints and the routes
with this command:
</para>
-<para><command>gpsbabel -i gpx -f bigfile.gpx -x nuketypes,waypoints,routes -o gpx -F tracksonly.gpx</command></para>
+<para><userinput>gpsbabel -i gpx -f bigfile.gpx -x nuketypes,waypoints,routes -o gpx -F tracksonly.gpx</userinput></para>
</example>
example, the duplicate filter is used to remove a list of waypoints to be
ignored from a larger collection of waypoints:
</para>
-<para><command>gpsbabel -i gpx -f waypoints.gpx -i csv -f to_ignore.csv -x duplicate,shortname,all -o gpx -F filtered.gpx</command></para>
+<para><userinput>gpsbabel -i gpx -f waypoints.gpx -i csv -f to_ignore.csv -x duplicate,shortname,all -o gpx -F filtered.gpx</userinput></para>
</example>
<example id="Correcting_Cache_Locations">
<title>Using the duplicate filter to correct the locations of "puzzle"
geocaches</title>
-<para><command>gpsbabel -i gpx -f 43622.gpx -i csv -f corrections.csv -x duplicate,shortname,correct -o gpx -F 43622-corrected.gpx</command></para>
+<para><userinput>gpsbabel -i gpx -f 43622.gpx -i csv -f corrections.csv -x duplicate,shortname,correct -o gpx -F 43622-corrected.gpx</userinput></para>
<para>
After this command is run, the waypoints in the output file will have all
of the descriptive information from <filename>43622.gpx</filename>, but
Suppose you want to merge tracks recorded with two different GPS devices
at the same time. To do that, use this command line:
</para>
-<para><command>gpsbabel -t -i gpx -f john.gpx -i gpx -f doe.gpx -x track,merge,title="COMBINED LOG" -o gpx -F john_doe.gpx</command></para>
+<para><userinput>gpsbabel -t -i gpx -f john.gpx -i gpx -f doe.gpx -x track,merge,title="COMBINED LOG" -o gpx -F john_doe.gpx</userinput></para>
</example>
<para>
The following command line will shift all tracks to be one hour later.
</para>
-<para><command>gpsbabel -t -i gpx -f in.gpx -x track,move=+1h -o gpx -F out.gpx</command></para>
+<para><userinput>gpsbabel -t -i gpx -f in.gpx -x track,move=+1h -o gpx -F out.gpx</userinput></para>
</example>
<para> For example, to split the track if the distance between
points is greater than 100 meters, use this:</para>
- <para><command>
+ <para><userinput>
gpsbabel -t
-i gpx -f in.gpx
-x track,pack,sdistance=0.1k"
-o gpx -F out.gpx
-</command></para>
+</userinput></para>
<para> The sdistance option can be combined with the split option.
The track then will be split only if both time and distance
interval exceeds the supplied values. This technique can be used to
This example splits the track
if the device is without signal for at least 5 minutes
and during this time moves more than 300 meters:</para>
- <para><command>
+ <para><userinput>
gpsbabel -t \
-i gpx -f in.gpx \
-x track,pack,sdistance=0.3k,split=5m \
-o gpx -F out.gpx
-</command></para>
+</userinput></para>
split a single tracks into separate tracks for each day and
name them, use this:
</para>
- <para><command> gpsbabel -t -i gpx -f in.gpx -x track,split,title="ACTIVE LOG # %Y%m%d" -o gpx -F out.gpx</command></para>
+ <para><userinput> gpsbabel -t -i gpx -f in.gpx -x track,split,title="ACTIVE LOG # %Y%m%d" -o gpx -F out.gpx</userinput></para>
<para> If the input has multiple tracks, pack them together before
splitting them back apart per day thusly: </para>
- <para><command> gpsbabel -t -i gpx -f in.gpx
+ <para><userinput> gpsbabel -t -i gpx -f in.gpx
-x track,pack,split,title="ACTIVE LOG # %D"
- -o gpx -F out.gpx</command></para>
+ -o gpx -F out.gpx</userinput></para>
<para> Additionally you can add an interval to the split
option. With this the track will be split if the time
between two points is greater than this parameter. The
</para>
<para> For example, to split a track based on an four hour
interval, use this:</para>
- <para><command>
+ <para><userinput>
gpsbabel -t
-i gpx -f in.gpx
-x track,pack,split=4h,title="LOG # %c"
-o gpx -F out.gpx
-</command></para>
+</userinput></para>
To get only the parts of a track that were mapped on 20 July 2005
between 10 AM and 6 PM, use this command line:
</para>
-<para><command>gpsbabel -t -i gpx -f in.gpx -x track,start=2005072010,stop=2005072018 -o gpx -F out.gpx </command></para>
+<para><userinput>gpsbabel -t -i gpx -f in.gpx -x track,start=2005072010,stop=2005072018 -o gpx -F out.gpx </userinput></para>
</example>
</para>
<example id="transform_del">
<title>Convert a GPX track to GPX waypoints, tossing the original track</title>
-<para><command>gpsbabel -i gpx -f blah.gpx -x transform,wpt=trk,del -o gpx -F converted.gpx</command></para>
+<para><userinput>gpsbabel -i gpx -f blah.gpx -x transform,wpt=trk,del -o gpx -F converted.gpx</userinput></para>
</example>
Say you you have a data file that came from CSV file that you want to convert
to a GPX route that can be loaded into Mapsource. Use the following command:
</para>
-<para><command>gpsbabel -i csv -f blah.txt -x transform,rte=wpt -o gdb -F blah.gdb</command></para>
+<para><userinput>gpsbabel -i csv -f blah.txt -x transform,rte=wpt -o gdb -F blah.gdb</userinput></para>
</example>
Say you you have a data file that came from CSV file that you want to convert
to a GPX track that can be loaded into Mapsource. Use the following command:
</para>
-<para><command>gpsbabel -i csv -f blah.txt -x transform,trk=wpt -o gdb -F blah.gdb</command></para>
+<para><userinput>gpsbabel -i csv -f blah.txt -x transform,trk=wpt -o gdb -F blah.gdb</userinput></para>
</example>
<para>
Say you you have a KML file that contains a track but you want to convert it to a CSV file that can contain only waypoints, perhaps to import into a spreadsheet. Use the following command:
</para>
-<para><command>gpsbabel -i kml -f blah.kml -x transform,wpt=trk -o csv -F blah.txt</command></para>
+<para><userinput>gpsbabel -i kml -f blah.kml -x transform,wpt=trk -o csv -F blah.txt</userinput></para>
</example>
called mycounty.txt. This command line will give you only the points
in your county:
</para>
-<para><command>gpsbabel -i geo -f 1.loc -x polygon,file=mycounty.txt -o mapsend -F 2.wpt</command></para>
+<para><userinput>gpsbabel -i geo -f 1.loc -x polygon,file=mycounty.txt -o mapsend -F 2.wpt</userinput></para>
</example>
<example id="example_in_or_close_to">
<title>Using the polygon and arc filters to find points in or nearly in a
buffer zone around it in case there are points nearby that should be in the
polygon but aren't quite.
</para>
-<para><command>
+<para><userinput>
gpsbabel -i gpx -f points.gpx -x stack,push -x polygon,file=mycounty.txt
-x stack,swap -x arc,file=mycounty.txt,distance=1k -x stack,pop,append
-x duplicate,shortname -o gpx -F nearmycounty.gpx
-</command></para>
+</userinput></para>
<para>
This command makes a copy of the points, finds the ones that are in your
your county, swaps that result with the copy of the original set of points,
The following command removes multiple points that are within
one foot of each other, leaving just one.
</para>
-<para><command>gpsbabel -i geo -f 1.loc -f 2.loc -x position,distance=1f -o mapsend -F 3.wpt</command></para>
+<para><userinput>gpsbabel -i geo -f 1.loc -f 2.loc -x position,distance=1f -o mapsend -F 3.wpt</userinput></para>
</example>
<para>This example command line would include only points within 1 1/2 miles
of N30.000 W 90.000</para>
-<para><command>gpsbabel -i geo -f 1.loc -x radius,distance=1.5M,lat=30.0,lon=-90.0 -o mapsend -F 2.wpt</command></para>
+<para><userinput>gpsbabel -i geo -f 1.loc -x radius,distance=1.5M,lat=30.0,lon=-90.0 -o mapsend -F 2.wpt</userinput></para>
</example>
wish to use with a Magellan GPS receiver that only supports up to 50 points
in a route:
</para>
-<para><command>gpsbabel -r -i saroute -f RoadTrip.anr -x simplify,count=50 -o magellan -F grocery.rte</command></para>
+<para><userinput>gpsbabel -r -i saroute -f RoadTrip.anr -x simplify,count=50 -o magellan -F grocery.rte</userinput></para>
duplicates can be removed with the DUPLICATE filter; see
above.)
</para>
- <para><command>
+ <para><userinput>
gpsbabel -i gpx -f in.gpx
-x stack,push,copy
-x polygon,file=county_a.txt
-x polygon,file=county_b.txt
-x stack,pop,append
-o gpx -F out.gpx
-</command></para>
+</userinput></para>
<para> This example reads a large list of waypoints and
extracts the points within 20 miles of each of two cities,
writing the waypoint descriptions into two different PalmDoc
files and exporting all of the points to the GPS receiver:
</para>
- <para><command>
+ <para><userinput>
gpsbabel -i gpx -f indiana.gpx
-x stack,push,copy
-x radius,lat=41.0765,lon=-85.1365,distance=20m
-o palmdoc,dbname=Indianapolis -F indianapolis.pdb
-x stack,pop,append
-o magellan -F fwaind.wpt
-</command></para>
+</userinput></para>
<para>
The following example show you how to create a route from a waypoint table.
</para>
- <para><command>gpsbabel -i csv waypts.txt -x transform,rte=wpt -o gpx -F route.gpx</command></para>
+ <para><userinput>gpsbabel -i csv waypts.txt -x transform,rte=wpt -o gpx -F route.gpx</userinput></para>
<para>
Only the first letter of option value decides which transformation will be done.
Depending on the used option it can be only 'W' for waypoints, 'R' for routes or
layers by doing something like this:
</para>
-<para><command>gpsbabel -i an1 -f one.an1 -f two.an1 -o an1 -F merged.an1</command></para>
+<para><userinput>gpsbabel -i an1 -f one.an1 -f two.an1 -o an1 -F merged.an1</userinput></para>
<para>
In this case, the merged data will contain all of the
</para>
<example id="sample_bcr_command">
<title>Sample BCR command with all options</title>
- <para><command>gpsbabel -r -i gpx -f in.gpx -o bcr,index=1,name="From A to B",radius=6371012 -F a_to_b.bcr</command></para>
+ <para><userinput>gpsbabel -r -i gpx -f in.gpx -o bcr,index=1,name="From A to B",radius=6371012 -F a_to_b.bcr</userinput></para>
</example>
them to a GPX file:
</para>
- <para><command>gpsbabel -i garmin -f usb: -o gpx -F blah.gpx</command></para>
+ <para><userinput>gpsbabel -i garmin -f usb: -o gpx -F blah.gpx</userinput></para>
<para>
If you have multiple units attached via USB, you may provide
"usb:0", "usb:1", and "usb:2". To get a list of recognized devices,
specifiy a negative number such as:
</para>
- <para><command>gpsbabel -i garmin -f usb:-1</command></para>
+ <para><userinput>gpsbabel -i garmin -f usb:-1</userinput></para>
<para>
When reporting problems with the Garmin format, be sure to include
debugging dumps by adding "-D9" to the command line, like:
</para>
- <para><command> gpsbabel -D9 -i garmin -f usb: -o gpx -F blah.gpx</command></para>
+ <para><userinput> gpsbabel -D9 -i garmin -f usb: -o gpx -F blah.gpx</userinput></para>
<para>
Custom icons are supported on units that support that.
</para>
<example id="all_garmin_txt_options">
<title>Command showing garmin_txt output with all options</title>
- <para><command>gpsbabel -i garmin_txt,date="MM/DD/YYYY",time="hh:mm:ss xx" -f in.txt -o garmin_txt,date="DD.MM.YYYY",datum="WGS 72",dist=m,prec=6,temp=c,time="HH:mm:ss",utc=+2 -F out.txt</command></para>
+ <para><userinput>gpsbabel -i garmin_txt,date="MM/DD/YYYY",time="hh:mm:ss xx" -f in.txt -o garmin_txt,date="DD.MM.YYYY",datum="WGS 72",dist=m,prec=6,temp=c,time="HH:mm:ss",utc=+2 -F out.txt</userinput></para>
</example>
Groundspeak extensions and writes an HTML file with encrypted hints
that is rendered using a custom stylesheet:
</para>
-<para><command>gpsbabel -i gpx -f 12345.gpx -o html,stylesheet=green.css,encrypt -F 12345.html</command></para>
+<para><userinput>gpsbabel -i gpx -f 12345.gpx -o html,stylesheet=green.css,encrypt -F 12345.html</userinput></para>
A track stored in another format (GPX for example) representing a recorded
flight can be converted into an IGC file:
</para>
-<para><command>gpsbabel -i gpx -f mytrk.gpx -o igc -F myflight.igc</command></para>
+<para><userinput>gpsbabel -i gpx -f mytrk.gpx -o igc -F myflight.igc</userinput></para>
<para>
If multiple track segments are provided in the input file, the one with the
most points will be used.
A route stored in another format representing a task declaration can be
converted into an IGC file:
</para>
-<para><command>gpsbabel -i gpx -f myrte.gpx -o igc -F mytask.igc</command></para>
+<para><userinput>gpsbabel -i gpx -f myrte.gpx -o igc -F mytask.igc</userinput></para>
<para>
A route and a track in other formats can be included into a single IGC file:
</para>
-<para><command>gpsbabel -i gpx -f mytrk.gpx -f myrte.gpx -o igc -F myflight.igc</command></para>
+<para><userinput>gpsbabel -i gpx -f mytrk.gpx -f myrte.gpx -o igc -F myflight.igc</userinput></para>
<para>
A similar result can be obtained by downloading the track log and routes
directly from a GPS device connected to a PC. For example to create an IGC
file from data recorded in a Garmin GPS connected to the first serial port of
a PC running Linux:
</para>
-<para><command>gpsbabel -t -r -i garmin -f /dev/ttyS0 -o igc -F myflight.igc</command></para>
+<para><userinput>gpsbabel -t -r -i garmin -f /dev/ttyS0 -o igc -F myflight.igc</userinput></para>
<para>
For Windows operating systems:
</para>
-<para><command>gpsbabel -t -r -i garmin -f com1 -o igc -F myflight.igc</command></para>
+<para><userinput>gpsbabel -t -r -i garmin -f com1 -o igc -F myflight.igc</userinput></para>
<para>
A waypoint file in another format containing a waypoint whose short name is
"PILOT" can be merged into an IGC file. The description field of the waypoint
will be used for the pilot name in the IGC file header:
</para>
-<para><command>gpsbabel -i gpx -f mytrk.gpx -f myrte.gpx -f mywpt.gpx -o igc -F myflight.igc
-gpsbabel -w -t -r -i garmin -f /dev/ttyS0 -o igc -F myflight.igc</command></para>
+<para><userinput>gpsbabel -i gpx -f mytrk.gpx -f myrte.gpx -f mywpt.gpx -o igc -F myflight.igc
+gpsbabel -w -t -r -i garmin -f /dev/ttyS0 -o igc -F myflight.igc</userinput></para>
<para>
Some formats such as GPX allow routes, tracks and waypoints to exist in the
same file and can be used to fully populate an IGC file:
</para>
-<para><command>gpsbabel -i gpx -f myall.gpx -o igc -F myflight.igc</command></para>
+<para><userinput>gpsbabel -i gpx -f myall.gpx -o igc -F myflight.igc</userinput></para>
</section>
<section id="fmt_igc_convfrom">
generate OziExplorer files containing tracks representing the recorded
flight (myozi.plt) and routes representing declared tasks (myozi.rte):
</para>
-<para><command>gpsbabel -i igc -f myflight.igc -o ozi -F myozi</command></para>
+<para><userinput>gpsbabel -i igc -f myflight.igc -o ozi -F myozi</userinput></para>
<para>
Or to GPX format:
</para>
-<para><command>gpsbabel -i igc -f myflight.igc -o gpx -F myflight.gpx</command></para>
+<para><userinput>gpsbabel -i igc -f myflight.igc -o gpx -F myflight.gpx</userinput></para>
<para>
Header information from the IGC file will be written to the description field
of the track(s).
A route stored in another format can be merged with an existing IGC file that
has no task declaration, to generate a new IGC file with a task declaration:
</para>
-<para><command>gpsbabel -i igc -f myflight.igc -i gpx -f myrte.gpx -o igc -F mynew.igc</command></para>
+<para><userinput>gpsbabel -i igc -f myflight.igc -i gpx -f myrte.gpx -o igc -F mynew.igc</userinput></para>
<para>
A two dimensional (lat/lon) track recorded during a flight by a GPS receiver
can be merged with a one dimensional (altitude) track recorded during the same
flight by a barograph instrument. The result is a three dimensional IGC file
representing the flight:
</para>
-<para><command>gpsbabel -i gpx -f baro.gpx -i igc -f my2D.igc -o igc -F my3D.igc</command></para>
+<para><userinput>gpsbabel -i gpx -f baro.gpx -i igc -f my2D.igc -o igc -F my3D.igc</userinput></para>
<para>
The same can be acheived by downloading directly from a barograph instrument
supported by GPSBabel. For example with a Brauniger IQ Comp GPS variometer:
</para>
-<para><command>gpsbabel -i baroiq -f /dev/ttyS0 -i igc -f my2D.igc -o igc,timeadj=auto -F my3D.igc</command></para>
+<para><userinput>gpsbabel -i baroiq -f /dev/ttyS0 -i igc -f my2D.igc -o igc,timeadj=auto -F my3D.igc</userinput></para>
<para>
or:
</para>
-<para><command>gpsbabel -i baroiq -f com1 -i igc -f my2D.igc -o igc,timeadj=auto -F my3D.igc</command></para>
+<para><userinput>gpsbabel -i baroiq -f com1 -i igc -f my2D.igc -o igc,timeadj=auto -F my3D.igc</userinput></para>
<para>
(Documentation contributed by Chris Jones, Aug 2004)
</para>
<para>
To merge the databases, use a command line like the following:
</para>
-<para><command>gpsbabel -i magnav -f Companion_Waypoints.PDB -i geo -f geocaching.loc -o magnav -F merged.pdb</command></para>
+<para><userinput>gpsbabel -i magnav -f Companion_Waypoints.PDB -i geo -f geocaching.loc -o magnav -F merged.pdb</userinput></para>
<para>
Second, you must use the installer to install your new PDB file. Don't
make the mistake of copying it over the existing Companion_Waypoints.PDB
<para>
Step 1: Create a mapconverter file using gpsbabel.
</para>
-<para><command>gpsbabel -i geo -f geocaching.loc -o mapconverter -F foo.txt</command></para>
+<para><userinput>gpsbabel -i geo -f geocaching.loc -o mapconverter -F foo.txt</userinput></para>
<para>
Step 2: Launch mapconverter.exe and choose foo.txt as your input file.
Click the begin button to have mapconverter process foo.txt.
format. Intended to serve as source for number-processing
applications like OpenOffice, Ploticus and others. Tab was chosen as
delimiter because it is a) supported by both OpenOffice and Ploticus
-and b) is not ',', so you can use <command moreinfo="none">sed -i
-"s/./,/g" <x>.csv'</command> to adapt it to locales where ',' is
+and b) is not ',', so you can use <userinput moreinfo="none">sed -i
+"s/./,/g" <x>.csv'</userinput> to adapt it to locales where ',' is
used as decimal seperator. Contributed by Tobias Minich.</para>
in the waypoint descriptions in the generated drawing file. If you do not
want that, specify the "nogc" option on the command line:
</para>
-<para><command>gpsbabel -i gpx -f 12345.gpx -o an1,nogc -F 12345.an1</command></para>
+<para><userinput>gpsbabel -i gpx -f 12345.gpx -o an1,nogc -F 12345.an1</userinput></para>
<link linkend="fmt_gpx">gpx</link> file that contains two routes, you may
use this option to write them one at a time to individual files.
</para>
-<para><command>gpsbabel -i gpx -f routes.gpx -o bcr,index=1 -F route1.bcr -o bcr,index=2 -F route2.bcr</command></para>
+<para><userinput>gpsbabel -i gpx -f routes.gpx -o bcr,index=1 -F route1.bcr -o bcr,index=2 -F route2.bcr</userinput></para>
<link linkend="fmt_gpx">gpx</link> file that contains two routes, you may
use this option to write them one at a time to individual files.
</para>
-<para><command>gpsbabel -i gpx -f routes.gpx -o compegps,index=1 -F route1.txt -o compegps,index=2 -F route2.txt</command></para>
+<para><userinput>gpsbabel -i gpx -f routes.gpx -o compegps,index=1 -F route1.txt -o compegps,index=2 -F route2.txt</userinput></para>
and returns it as a single waypoint for further processing. For example,
to return the current position from a USB Garmin to a KML file:
</para>
-<para><command>gpsbabel -i garmin,get_posn -f usb: -o kml -F myposition.kml</command></para>
+<para><userinput>gpsbabel -i garmin,get_posn -f usb: -o kml -F myposition.kml</userinput></para>
in your command.
</para>
-<para><command>gpsbabel -o garmin,power_off -F /dev/ttyS0</command></para>
+<para><userinput>gpsbabel -o garmin,power_off -F /dev/ttyS0</userinput></para>
difference in seconds between the two time domains through the "timeadj"
parameter. This can be any positive or negative integer:
</para>
-<para><command>gpsbabel -i gpx -f baro.gpx -i igc -f my2D.igc -o igc,timeadj=27 -F my3D.igc</command></para>
+<para><userinput>gpsbabel -i gpx -f baro.gpx -i igc -f my2D.igc -o igc,timeadj=27 -F my3D.igc</userinput></para>
<para>
GPSBabel can also attempt to deduce the time difference automatically. This
is done by comparing the time that it thinks that you landed on the GPS track
and the barograph and adjusting accordingly:
</para>
-<para><command>gpsbabel -i gpx -f baro.gpx -i igc -f my2D.igc -o igc,timeadj=auto -F my3D.igc</command></para>
+<para><userinput>gpsbabel -i gpx -f baro.gpx -i igc -f my2D.igc -o igc,timeadj=auto -F my3D.igc</userinput></para>
<link linkend="fmt_gpx">gpx</link> file that contains two tracks, you may
use this option to write them one at a time to individual files.
</para>
-<para><command>gpsbabel -i gpx -f tracks.gpx -o ignrando,index=1 -F track1.txt -o ignrando,index=2 -F track2.txt</command></para>
+<para><userinput>gpsbabel -i gpx -f tracks.gpx -o ignrando,index=1 -F track1.txt -o ignrando,index=2 -F track2.txt</userinput></para>
<link linkend="fmt_gpx">gpx</link> file that contains two routes, you may
use this option to write them one at a time to individual files.
</para>
-<para><command>gpsbabel -i gpx -f routes.gpx -o nmn4,index=1 -F route1.rte -o nmn4,index=2 -F route2.rte</command></para>
+<para><userinput>gpsbabel -i gpx -f routes.gpx -o nmn4,index=1 -F route1.rte -o nmn4,index=2 -F route2.rte</userinput></para>
<para>
This example will convert route number two and three into separate sdf files:
</para>
- <para><command> gpsbabel -i gdb -f routes.gdb -r -o stmsdf,index=2 -F route-one.sdf -r -o stmsdf,index=3 -F route-three.sdf </command></para>
+ <para><userinput> gpsbabel -i gdb -f routes.gdb -r -o stmsdf,index=2 -F route-one.sdf -r -o stmsdf,index=3 -F route-three.sdf </userinput></para>
<link linkend="fmt_gpx">gpx</link> file that contains three routes, you may
use this option to write them one at a time to individual files.
</para>
-<para><command>gpsbabel -i gpx -f routes.gpx -o stmwpp,index=1 -F route1.txt -o stmwpp,index=2 -F route2.txt -o stmwpp,index=3 -F route3.txt</command></para>
+<para><userinput>gpsbabel -i gpx -f routes.gpx -o stmwpp,index=1 -F route1.txt -o stmwpp,index=2 -F route2.txt -o stmwpp,index=3 -F route3.txt</userinput></para>
and centered.
</para>
<para>For example:</para>
-<para><command>gpsbabel -i geo -f geocaching.loc -o tiger,genurl=tiger.ctr -F tiger.dat</command></para>
+<para><userinput>gpsbabel -i geo -f geocaching.loc -o tiger,genurl=tiger.ctr -F tiger.dat</userinput></para>
<para>
may create tiger.ctr with
<screen format="linespecific">
The following command line reads a GPX file with Groundspeak extensions
and writes a Palm document with encrypted hints and logs:
</para>
-<para><command>gpsbabel -i gpx -f 12345.gpx -o "palmdoc,dbname=Unfound Geocaches,encrypt,logs" -F 12345.pdb</command></para>
+<para><userinput>gpsbabel -i gpx -f 12345.gpx -o "palmdoc,dbname=Unfound Geocaches,encrypt,logs" -F 12345.pdb</userinput></para>
on the command line. A simple command line to create PSP files
looks like this:
</para>
-<para><command>gpsbabel -i geo -f geocaching.loc -o psp -F NewOrleans.psp</command></para>
+<para><userinput>gpsbabel -i geo -f geocaching.loc -o psp -F NewOrleans.psp</userinput></para>
<para>
Note the use of "-f" for INPUT files and "-F" for OUTPUT files.
</para>
<member>28 = X9 TrackLog</member>
</simplelist>
</para>
- <para><command>gpsbabel -i gpx -f some-routes.gpx -r -o stmsdf,index=3 -F single-route.sdf</command></para>
+ <para><userinput>gpsbabel -i gpx -f some-routes.gpx -r -o stmsdf,index=3 -F single-route.sdf</userinput></para>
<para>
<ulink url="http://www.suunto.fi">Suunto Website</ulink>
</para>
may also be used with this program and supports both reading and writing.
</para>
-<para><command> gpsbabel -r -i tef,routevia -f in.xml -o gpx -F out.gpx</command></para>
+<para><userinput> gpsbabel -r -i tef,routevia -f in.xml -o gpx -F out.gpx</userinput></para>
<para> The following command line reads a GPX file with
Groundspeak extensions and writes a text file with encrypted hints:
</para>
-<para><command>gpsbabel -i gpx -f 12345.gpx -o text,encrypt -F 12345.txt</command></para>
+<para><userinput>gpsbabel -i gpx -f 12345.gpx -o text,encrypt -F 12345.txt</userinput></para>
</para>
<example id="wbt-bin-on-macos">
<title>Command showing conversion of a Wintec binary file to GPX</title>
- <para><command>gpsbabel -i wbt-bin -f tracks.bin -o
-gpx -F out.gpx</command></para>
+ <para><userinput>gpsbabel -i wbt-bin -f tracks.bin -o
+gpx -F out.gpx</userinput></para>
</example>
</para>
<example id="wbt-on-macos">
<title>Command showing WBT-200 download and erase over Bluetooth on Mac OS X</title>
- <para><command>gpsbabel -i wbt,erase -f /dev/cu.WBT200-SPPslave-1 -o gpx -F out.gpx</command></para>
+ <para><userinput>gpsbabel -i wbt,erase -f /dev/cu.WBT200-SPPslave-1 -o gpx -F out.gpx</userinput></para>
</example>
is indeed possible, but if you have more than a few points, it can be a task.
For example:
</para>
-<para><command>gpsbabel -i xmapwpt -f Xmap1.wpt -f Xmap2.wpt -o mapsend -F mapsend.wpt</command></para>
+<para><userinput>gpsbabel -i xmapwpt -f Xmap1.wpt -f Xmap2.wpt -o mapsend -F mapsend.wpt</userinput></para>
<para>
will read the two Xmap .wpt files and write one mapsend file. This
is fine for a small handful of points, but could be quite cumbersome
for folks like me who have 100+ waypoints loaded into XMap. For *nix
folks, something as simple as:
</para>
-<para><command>cat *.wpt > /tmp/foo.wpt</command>
-<command>gpsbabel -i xmapwpt -f foo.wpt -o mapsend -F mapsend.wpt </command></para>
+<para><userinput>cat *.wpt > /tmp/foo.wpt</userinput>
+<userinput>gpsbabel -i xmapwpt -f foo.wpt -o mapsend -F mapsend.wpt </userinput></para>
<para>
will do the trick just fine.
</para>
<refsynopsisdiv>
<cmdsynopsis>
-<command>gpsbabel</command>
+<userinput>gpsbabel</userinput>
<arg choice="opt">
<option>iofFxsh</option>
</arg>
Routenplaner 2002-..." by Map&Guide. It is a route-onle
format. If you own a newer release (2005...) you can also use the XML
export and convert via <command moreinfo="none">gpsbabel ... -i tef
-...</command> to your preferred format. May be there are other
+...</userinput> to your preferred format. May be there are other
products from Map&Guide using the format.
</para>
<para> Coordinates are stored in Mercator format. The
applications like OpenOffice, Ploticus and others. Tab was chosen as
delimiter because it is a) supported by both OpenOffice and Ploticus
and b) is not ',', so you can use <command moreinfo="none">sed -i
-"s/./,/g" <x>.csv'</command> to adapt it to locales where ',' is
+"s/./,/g" <x>.csv'</userinput> to adapt it to locales where ',' is
used as decimal seperator. Contributed by Tobias Minich.</para>
</section>
<section id="ozi">
By itself, it doesn't comply to any format, however *most* CSV
variants can be described as a "style" and fine-tuned by the end user.
For more information on it's use, please see README.style in the
-style/ sub-directory of <command moreinfo="none">GPSBabel</command>.
+style/ sub-directory of <command moreinfo="none">GPSBabel</userinput>.
For an example of using the XCSV module within your C program, look at
the <filename moreinfo="none">ozi.c</filename>, <filename
moreinfo="none">mxf.c</filename>, and <filename